<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  <meta http-equiv="Content-Style-Type" content="text/css">
  <title></title>
  <meta name="Generator" content="Cocoa HTML Writer">
  <meta name="CocoaVersion" content="949.54">
  <style type="text/css">
    body {background-color: #FFFFFF}
    p.p1 {margin: 0.0px 0.0px 0.0px 0.0px; font: 26.0px Helvetica}
    p.p2 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica}
    p.p3 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; min-height: 14.0px}
    p.p4 {margin: 0.0px 0.0px 12.0px 0.0px; font: 12.0px Helvetica}
    p.p5 {margin: 0.0px 0.0px 0.0px 49.0px; font: 12.0px Helvetica}
    span.s1 {color: #0000ed}
    span.s2 {text-decoration: underline}
    span.s3 {color: #0000eb}
    span.Apple-tab-span {white-space:pre}
  </style>
</head>
<body>
<p class="p1"><b>crange</b></p>
<p class="p2">a range slider.</p>
<p class="p3"><br></p>
<p class="p2"><b>DESCRIPTION</b></p>
<p class="p4">When created, the range slider is stacked in the slider pane of the main Cecilia window in the order it is defined. 
	The values of the range slider are passed to the orchestra with two variables. The range minimum is collected 
	using <i>gkvariable_name</i><b><i>min</i></b><i> </i>for a range slider whose -<b>rate</b> is k and<i> givariable_name</i><b><i>min</i></b><i> </i>if the slider has a -<b>rate</b> value of
	 i.<span class="Apple-converted-space">  </span>
	The range maximum is collected using <i>gkvariable_name</i><b><i>max</i></b><i> </i>for a range slider whose -<b>rate</b> is k and<i> givariable_name</i><b><i>max
		</i></b><i> </i>if the range slider has a -<b>rate</b> value of i. The -<b>up</b> flag passes the values of the range on mouse-up if set to 1 or passes on 
		mouse-down if set to 0.	The -<b>gliss flag </b>determines the duration of the portamento (in sec).<span class="Apple-converted-space">  </span>The resolution of the range
		slider can be set to int or float using the -<b>res</b> flag. Slider colour can be set using the -<b>col</b> flag and a <a href="./colourArgs.html">colour argument</a>.<span class="Apple-converted-space"> </span></p>
<p class="p4">Every time a range slider is defined, two graph line are automatically defined for the grapher in the Cecilia grapher pane. One is linked to the minimum value of the range, the other one to the maximum value of the range. The recording and playback of an automated slider is linked to its graph line. 
	For further informations, refer to the <a href="./slider.html">Slider</a> section.</p>
<p class="p4">	<span class="Apple-converted-space">  </span> NOTE: in order to quickly select the minimum value (and graph line), you can click on the left side of the crange label, to select the maximum value (and graph line), click on the right side of the label.
<p class="p3"><br></p>
<p class="p2"><b>INTERFACE SYNTAX</b></p>
<p class="p2"><span class="Apple-tab-span">	</span><b>crange</b></p>
<p class="p2"><b><span class="Apple-tab-span">	</span></b>(compulsory)</p>
<p class="p2"><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><b>variable_name</b> (mandatory, no spaces allowed)</p>
<p class="p2"><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><b>-label</b> <span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>Text showing in Cecilia slider pane (spaces allowed). Default value = ''</p>
<p class="p2"><b><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>-min</b> <span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>Minimum value (numerical). Default value = 0</p>
<p class="p2"><b><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>-max <span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span></b>Maximum value (numerical). Default value = 1</p>
<p class="p2"><span class="Apple-tab-span">	</span>(optional)</p>
<p class="p2"><b><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>-init</b> <span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>Pair of initial range values (numerical) separated by a comma. Default value = min value, max value</p>
<p class="p2"><b><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>-unit</b> <span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>Unit symbol showing in Cecilia slider pane (text). Default value = ''</p>
<p class="p2"><b><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>-res</b><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>Slider resolution {float, int}. Default value = float</p>
<p class="p2"><b><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>-rate</b><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>Update rates of the csound value {k, i}. Default value = k</p>
<p class="p2"><b><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>-gliss</b><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>Portamento between values in seconds. Default value = 0.025</p>
<p class="p2"><b><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>-rel</b><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>Slider scaling {lin, log}. Default value = lin</p>
<p class="p2"><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><b>-up</b><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>Value passed on mouse up (0 = on mouse down, 1 = on mouse up). Default = 0</p>
<p class="p2"><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><b>-midictl</b><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>MIDI controller number assigned to the slider (numerical). Default value = -1 (None)</p>
<p class="p2"><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><b>-col</b><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>Colour of the slider (see <a href="./colourArgs.html">Colour arguments</a>). A default colour is applied by Cecilia</p>
<p class="p2"><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><b>-help</b><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>Text for tooltips (space allowed) Default value = ''</p>
<p class="p3"><br></p>
<p class="p2"><b>ORCHESTRA SYNTAX</b></p>
<p class="p2"><b><span class="Apple-tab-span">	</span></b>krandomFreq<span class="Apple-converted-space">  </span>random<span class="Apple-converted-space">  </span><b><i>gkfreqmin</i></b>, <b><i>gkfreqmax</i></b></p>
<p class="p5"><i> </i></p>
<p class="p2"><b><i><span class="Apple-tab-span">	</span>gkfreqmin</i></b> and <b><i>gkfreqmax</i></b> would be the minimum and maximum values directly obtained from a range slider whose variable name <span class="Apple-tab-span">	</span>is respectively <i>freq</i> with a -<b>rate</b> of k.</p>
<p class="p3"><br></p>
<p class="p2"><b>EXAMPLES</b></p>
<p class="p2"><span class="Apple-tab-span">	</span><b>crange </b>freq<b> -label </b>Pitch range<b> -unit </b>pch<b> -min </b>1<b> -max </b>90<b> -init </b>40,80<b><span class="Apple-converted-space">  </span>-col </b>red</p>
<p class="p2"><span class="Apple-tab-span">	</span><b>crange </b>speed<b> -label </b>Speed range<b> -unit </b>Hz<b> -rel </b>log<b> -min </b>0.01<b> -max </b>100<b> -init </b>1, 10<b> -col </b>green</p>
<p class="p2"><span class="Apple-tab-span">	</span><b>crange </b>dur<b> -label </b>Duration range<b> -min </b>.005<b> -max </b>5</p>
<p class="p2"><span class="Apple-tab-span">	</span><b>crange </b>intensity<b> -label </b>Intensity<b> </b>range<b> -unit </b>db<b> -min </b>30<b> -max </b>90<b> -init </b>50.0, 80.0<b> -col </b>orange <b>\\</b></p>
<p class="p2"><b><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>-help </b>Range of intensity of the grains</p>
<p class="p3"><br><br></p>
<center><p class="p3">Return to <a href="./buildInterface.html">Building Cecilia's Interface</a> section</p></center>
</body>
</html>
